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Introduction 



About This GUiClG This guide describes the machine-specific aspects of the im- 
plementation of HP-UX Technical BASIC on the Integral 
Personal Computer. 

HP-UX Technical BASIC is a new version of BASIC devel- 
oped from Series 80 BASIC for the HP-UX series of 
computers. It includes most of the Series 80 keywords found 
in Series 80 BASIC, including the keywords found in the Ad- 
vanced Programming ROM, Printer/Plotter ROM, I/O ROM 
and the Matrix ROM. Although the language is similar, the 
interpreter itself will not run on Series 80 computers. This 
guide also describes how to transfer Series 80 programs and 
data files to the Integral Personal Computer. In most cases. 
Series 80 programs will run with only slight modifications. 

Because of the machine-specific differences among HP-UX 
computers, the implementation of HP-UX Technical BASIC 
on each machine is slightly different. These machine-specific 
differences include: 

■ Special keys (including cursor keys, editing keys and func- 
tion keys) 

■ Graphics capability 

■ Multiple window environment 

■ Printer enhancements 

■ Display enhancements 

■ BASIC Keyword differences 

■ Memory speed 
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This guide provides information on each of these features to 
allow you to get the most out of the advanced features of 
your Integral PC. 

This guide is divided into three chapters. The information in 
the three chapters is summarized below. 

Chapter 1: Introduction 

Summarizes what information is in this manual. 

Chapter 2: Integral PC Specifics 

This chapter summarizes the machine-specific capabilities of 
the Integral PC that may be used from HP-UX Technical BA- 
SIC programs. 

Chapter 3: Uploading Series 80 BASIC Files 

This chapter desribes how to transfer Series 80 files to the 
Integral PC using the upload program provided with the BA- 
SIC interpreter. 



Where to Find 

More 

Information 



For more information on HP-UX Technical BASIC, refer to 
one of the following manuals: 

1 . HP-UX Technical BASIC Getting Started Guide* 

2. HP-UX Technical BASIC Reference* 

3. HP-UX Technical BASIC Implementation Guide* 

4. HP-UX Technical BASIC I/O Programming Guide-\ 
(82978-90001) 

5. HP-UX Technical BASIC Programming Guide1[ (98680- 
90035) 



* Provided with HP-UX Technical BASIC Interpreter. 
tMay be ordered separately. 
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The Keyboard 



Integral PC Specifics 

This section describes some of the machine-specific features 
of the Integral PC keyboard. For a general discussion of how 
to use the keyboard, refer to chapter 3 of the user's guide. For 
a discussion of how to use the keyboard specifically with 
HP-UX Technical BASIC, refer to one of the following 
sections: 

■ BASIC Function Keys 

■ Programming the Function Keys 

■ The OH KYBD Statement 

■ Keyboard Escape Sequences 



BASIC Function 
Keys 



On the Integral PC, BASIC makes the following typing aid 
assignments to the function keys. Immediate-execute keys in- 
clude a terminating carriage return; pressing the key is 
equivalent to typing the command and pressing ( Return ) . 

BASIC Function Keys 



Key 


Key Label 


IVpIng Aid 


Immediate 
Execute? 


(iU 

(f2) 
03) 
(J4j 


LIST 
RUN 
STEP 
CONT 


LIST (without parameters) 

RUN (without parameter) 

SINGLESTEP 

CONT (without parameter) 


Yes 
Yes 
Yes 
Yes 
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BASIC Function Keys (continued) 



Key 


Key Label 


IVping Aid 


Immediate 
Execute? 


(f5) 

(iZJ 

(f9) 

(fio) 

(f1l) 
(f12) 
(f13) 
(f14) 
(f15) 


SCRATCH 1 
PRT IS 
PLIST 
KEY LAB. 
MS. !S 
DELETE 
LOAD 
STORE 
TR. ALL 
CRT IS 
INIT 


SCRATCH 

PRINTER IS 

PLIST 

KEY LABEL 

MASS STORAGE IS 

DELETE 

LOAD 

STORE 

TRACE ALL 

CRT IS 

INIT 


No 
No 
Yes 
Yes 
No 
No 
No 
No 
Yes 
No 
Yes 


(f16) 


EXIT 


Exits BASIC 


Yes 



Programming the 
Function Keys 



The eight function keys ((TT) through CfS)) on the Integral PC 
keyboard may be used with the shift key to provide up to 16 
function keys. The unshifted keys are (TT) through (l8~) ; the 
shift key is used to access (W) through ( f 1 6 ) . 



The function keys may be used both from the keyboard (as 
typing aids) or from a BASIC program. To program the func- 
tion keys, use the ON KEV# statement to define the key 
labels and functions. For example: 

1 H K E Y # 16, " Repeat " g o t o 1 S 8 

This statement will display the key label Repeat for (fi6) . It 
will cause the program to branch to statement 100 when 
( Shift )(l8) is pressed. 
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To redefine the typing aids available from the keyboard, use 
the ON KEY# statement without a line number. For example, 
to assign the CLERR statement to the (W) function key enter 
the following statement: 



H K E Y # 9 , " C L E n R " , " C L E H R ■■- 1 3 " ( Return ) 

Pressing (W) is equivalent to typing the C L E fl R statement and 
pressing return. 



UH KVBD The OH KVBD statement is used to initiate program branch- 
StStGinCnt ^^8 when a specific key is pressed. The escape sequences 
returned by the special keys on the Integral PC keyboard 
have been remapped in BASIC from the standard TermO se- 
quences to the escape sequences listed in the following 
section. The escape sequence consists of the escape character 
plus one alphabetic character. For example, the escape se- 
quence for the (h) function key is "■■■•366" or 
C H R $ < £ 7 ':> :i: " n " . To branch on this key, enter one of the fol- 
lowing statements: 

1 N K Y B V a 1 u e , " ■•- 366" G TO 99 9 

or 

10 ON KYBD value.. CHR$ < £7 > & " n " GOTO 999 

When the key specified by the string expression is pressed, 
the ON KYBD statement returns a value equal to the ASCII 
value of the alphabetic character plus 256. For example, when 
function key (IT) is pressed the variable va 1 ue is assigned the 
value 366 (the decimal ASCII value of the letter n plus 256). 
Testing the value of the numeric variable provides a method 
of identifying the key causing the interupt when the string 
expression enables branching on more than one key. 
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Keyboard Escape 
Sequences 



The following table provides a list of escape sequences re- 
turned by the Integral PC keyboard. (Because these escape 
sequences have been remapped, these values are valid only 
while running HP-UX Technical BASIC.) 



Keyboard Escape Sequences 



Key Name 


Numeric 
Key Code 


BASIC Escape 
Sequence 


QD 


363 


■■•••027 k 


(f2) 


364 


■-027 1 


(f3) 


365 


■■■•■ 027 rn 


(f4) 


366 


•-027n 


(f5) 


367 


■■■■■027o 


(J6j 


368 


■■■■■ 2 7 p 


(f7) 


369 


■■•••027':i 


(f8) 


360 


■•■■■027r 


(f9) 


371 


■■■■■027s 


(f10) 


372 


- •■ 2 7 t 


(f1l) 


373 


• ■•■ 027 u 


(f12) 


374 


--02 7 v 


(f13) 


375 


•-0271...I 


(f14) 


376 


••■-02 7 X 


(f15) 


377 


•■■- 2 7 y 


(f16) 


378 


•-02 7z 


(y) 


360 


•-02 7h 


( Shift )(y) 


326 
331 
330 
332 
333 


••-02 7F 
•-027K 
•-02 7 J 
••-02 7 L 
••-02 7 M 


( Clear line ) 


( Clear display ) 


( Insert line) 


( Delete line ) 
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Keyboard Escape Sequences (continued) 



Key Name 


Numeric 
Key Code 


BASIC Escape 
Sequence 


( Shift )( Tab ) 


361 


••■•■ 2 7 i 


(Tab) 


329 
337 
338 
336 


•••••0271 
■■- 2 7 Q 
■•-027R 
•■•••027P 


[ Insert char) (Mode On) 


( Insert char) (Mode Off) 


( Delete char ) 


( Prev ) 


342 


•••••027'...' 


( Next ) 


341 


•••••0271.1 


(S 


321 


••027FI 


® 


324 


•••••027D 


® 


322 


•••••0 27B 


® 


333 


•■-027C 


( Shift )( A ) 


339 


•■••• 027 S 


( Shift )(jrj 


340 


•■•••027T 



Alpha Display 



The BASIC alpha window is created when the BASIC inter- 
preter is invoked. The initial size of the window is 24 lines by 
80 columns. The alpha window is a view into a 32 line by 160 
column display buffer. Like other windows on the Integral 
PC, thef^^^BI (QD) and^^^^ ((J2)) function keys may 
be used to change the window. For information on how to 
control the alpha window, refer to chapter 2 of the compre- 
hensive guide. 
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Figure 2-1. 
Size of the Alpha Window 



The size of both the alpha window and display buffer is 
shown below. 



Alpha 

Window 

24 lines x 80 columns 



BASIC Screen Memory 
32 lines x 160 columns 



To change the position of the alpha window with respect to 
the display buffer, use the ( Shift ) key in combination with the 
arrow keys. 

The normal mode for the alpha display is black characters on 
a white field. The window may be inverted by pressing the 
Invert (Qs)) function key on the system menu. 

Other display modes may be obtained by sending the appro- 
priate escape sequences to the display. The display modes are 
field- oriented. The escape sequences given below only affect 
the line from the current cursor position to the end of the 
line, or until the next escape sequence, whichever occurs first. 
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For example, to print one word in inverse mode, enter the 
following statement: 



10 DISP 



■&:dB INVERSE! ■•-27ii:dil" 



Display Escape Sequences 



Key Sequence 


BASIC Escape 
Sequence 


Effect 


(ESC)&dB 


■•-27&dB 
--27&dD 
-••27$.:dF 

•■•••27g.:d@ 


Inverse mode. 

Underline mode. 

Inverse and underline 
mode. 

Turn off all display 
enhancements. 


(ESC)&dD 


(ESC)&dF 


{ESC)&d@ 



Screen Editing 



HP-UX Technical BASIC on the Integral PC has limited screen 
editing capabilities. This means that any program line or 
statement on the 32 line screen buffer may be edited by sim- 
ply moving the cursor to that line and using a combination of 
the ( Insert chaF) , ( Delete char) , ( Backspace^ and ( Clear line ) editing 
keys. The line can then be entered into program memory by 
pressing ( Return ) . Once a program statement has been entered 
into program memory it will not be lost until it is deleted, 
overwritten, or erased using the SCRATCH, LOFID, or CHAIN 
command. 

For an example of screen editing, refer to chapter 3 of the 
getting started guide. For more information about BASIC 
editing functions, refer to the HP-UX Technical BASIC Pro- 
gramming Guide. 
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Multiple 
Windows 



HP-UX Technical BASIC runs in a multi-tasking environment 
on the Intergral PC. This means that users can have several 
processes running at the same time. For example, you may 
start a program in the BASIC window and then return to the 
PAM window. From the PAM window you can start other 
programs while your BASIC program is running. Multiple 
windows are also useful when you need to run a system util- 
ity while you are in BASIC. To format a disc, for example, 
simply return to PAM and run the format— disc utility, then 
return to BASIC and continue. 

Both the BASIC interpreter and your BASIC programs run in 
the BASIC alpha window. If the BASIC program uses graphic 
statements the BASIC interpreter will create a BASIC graphics 
window. 



BASIC Graphics 



HP-UX Technical BASIC contains approximately 47 BASIC 
keywords used to control the graphics window or plot. This 
section will discuss some of the machine specific aspects of 
graphics. For more information on how to program using the 
graphics statements, refer to HP-UX Technical BASIC Program- 
ming Guide. 

To enable you to use the BASIC graphics statements, the BA- 
SIC interpreter will automatically load the HP-GL (Hewlett- 
Packard Graphics Language) driver contained on the BASIC 
disc. And, unless the plotting device has been reassigned, it 
will also automatically create a BASIC graphics window when 
the first graphics statement is executed. 
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Graphics Window 



The BASIC graphics window is a view into the graphics 
buffer. The graphics buffer is a 512 by 255 array of bits in 
memory. When plotted on the display this corresponds to 
roughly 2.8 dots per millimeter over the entire 18 by 9 cm 
display. The size of the graphics window is initially 162 mm 
by 67 mm. But like other windows, its size can be changed 
with the Stretch ((I2)) function key and moved with the 

Move (QD) function key (both on the graphic window's 
system menu). The size of the graphics buffer and the initial 
position of the graphics window are illustrated below. 



Figure 2.2 

Size of the Graphics 

Window 



Graphics Memory Buffer 
18 X 9 cm 



Graphics 
Window 



I 
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Again, like other windows, the graphics window can be posi- 
tioned over any portion of the plotter buffer by using the 
( Shift ) key in combination with the cursor keys. The effect is as 
if the plotter buffer is "sliding" under the window. 

Operation Key Description 

Roll left. ( Shift ) C<) Moves the plotter buffer left. 

Roll right. ( Shift )C>) Moves the plotter buffer right. 

Roll up. ( Shift )Cv) Moves the plotter buffer up. 

Roll down. ( Shift )Cf) Moves the plotter buffer down. 



DigitizinQ The integral PC has the capability to digitize from either the 
internal plotter or from a peripheral plotter. The syntax for 
the DIGITIZE statement is: 

DIGITIZE ;K P o s i t i o n , Y P o s i t i o n , P ens tat u s 

Digitizing From the internal Display. When the 
DIGITIZE statement is executed from a program, it will cre- 
ate a graphics window and display the pen icon. Once the 
pen icon appears, use the cursor keys to position the pen on 
the plotter bed of the internal display. Press the ( Enter ) to en- 
ter the pen coordinates (the computer will beep to acknow- 
ledge the input). Press ( Break ) to pause the program and abort 
the digitizing. 
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To use the DIGITIZE statement directly from the keyboard 
(in the immediate execute mode), use the following 
procedure: 



1 . Enter the DIGITIZE statement followed by a ( Return ) . 
For example: DIGITIZE K , Y 

2. Select the graphics window using the display pointer. 

3. Move the pen icon with a combination of ( Select ) and 
cursor keys. For example, to move the pen to the right 
press ( Select )(V) simultaneously. 



4. 



5. 



Press ( Enter ) key to enter the pen coordinates. (The pen 
icon will disappear.) 

Shuffle windows to return to the BASIC alpha window. 



Digitizing From a Peripiierai Plotter. Peripheral plotters 
using the HP-GL (Hewlett-Packard Graphics Language) in- 
struction set may also be used to digitize. Use the arrow keys 
located on the plotter to move the pen. To enter the pen co- 
ordinates, press the ( Enter ) key on the left of the Integral PC 
keyboard or the ( Enter ) key provided on the peripheral plotter. 



Keyword Specifics 



BPLOT. The maximum number of raster dots per row on the 
Integral PC is 512. This corresponds to 64 bytes per row. 

PEN. The color of the dots plotted on the graphics display 
can be inverted using the Invert ((W)) key on the BASIC 
graphics window system menu. 



Graphics IMenu 



The Graph menu function keys can be used with the BASIC 
graphic window. To display the menu when the graphics 
window is active, press Graphics i(j5)) on the system menu. 
For more information on the Graph menu, refer to page 2-22 
in the comprehensive guide. 
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Statement 



The volume labels on discs may be renamed using the 
'..■' L U M E I S statement. Peripheral disc drive device names 
on the Integral PC consist of the upper case letter D followed 
by three digits; volume number, HP -IB address, and disc 
drive number. For example, D020 is the device name of vol- 
ume of disc drive number with HP -IB address 2. The full 
path name of the device file is /dev/D020. The one notable 
exception to this naming scheme is the internal disc drive 
which is named internal. 

For more information on the naming conventions for disc 
drive devices on the Integral PC, refer to chapter 5 of the 
comprehensive guide. 



BEEP Statement 



The BEEP statement on the Integral PC includes both the 
pitch and length parameters. The pitch parameter is inter- 
preted as cycles per second, the length parameter in 
hundreths of a second. 



Printer 
Enhancements 



The built in Inkjet printer in the Integral PC may be con- 
trolled from BASIC by using escape sequences or control 
characters. 
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To send an escape sequence to the printer, use " ••• £ ? " or 
C H R $ >:: 2 7 ':■> concatenated with the escape character. For ex- 
ample, to send the command to skip over the perforations 
( (ESC) llL), use one of the following BASIC statements: 



10 PRINT 



711L 



or 



10 PRINT CHR*'::27::'&" IIL 



The printer control codes can be sent by using the BASIC es- 
cape sequence listed below or by using the CHR* function. 
For example, to send a command to enable bold print, use 
one of the following statements: 



10 PRINT 



14 



or 



10 PRINT CHR$a4> 



The following list summarizes both the control and escape se- 
quences used to control the built-in Inkjet printer. For more 
information on the printer enhancement escape sequences 
and control codes, refer to appendix D of the comprehensive 
guide. For information on escape sequences for peripheral 
printers, refer to the owner's manual for that printer. 



Printer Escape Sequences 



Key Sequence 


BASIC Escape 
Sequence 


Function 


( ESC ) = 


-■■27 
■■-27&:k{n}S 

■•-27ii:dD 
•■•••27&de 


Half Line Feed. 

Set print pitch {n}, wliere 
{n} = 0,1,2,3. 

Enable underline mode. 

Disable underline mode. 


(ESC)&k{A7}S 


(ESC)&clD 


(ESC)&d@ 



Integral PC Specifics 2-13 



Printer Escape Sequences 



Key Sequence 


BASIC Escape 
Sequence 


Function 




■•■■■27M.:lbD 
•••■•27ii:18D 

•••.•27f;a IL 
-£7&l{n}P 
•■■.■27&:l{n}F 

. i~. 
■■ «_' 

..... 1 
..... 1 2 
..... 1 4 
-.• 1 5 
-.• 1 3 
-.•274: 10L 

•■•••2 7;i:sec 

•■■.■27f!.:slC 


Set line spacing to 6 lines 
per inch. 

Set line spacing to 8 lines 
per inch. 

Enable skip perforation 
mode. 

Specify total length of {n} 
lines per page. 

Set {n} lines of text per 
page. 

Backspace. 

Line Feed. 

Form Feed. 

Bold Print. 

Disable Bold Print. 

Carriage Return. 

Disable skip perforation 
mode. 

Enable Wrap-Around 
Mode. 

Disable Wrap-Around 
Mode. 


(ESC)&I6D 


(ESC)&I8D 


(ESC)&I1L 


(ESC)&l{n}P 


(ESC)&l{n}F 


(CTRL)H 


(CTRL) J 


(CTRL)L 


(CTRL)N 


(CTRL)O 


(CTRL)M 
(ESC)&IOL 


(ESC)&S0C 


(ESC)&S1C 
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Programming 
I/O Devices 



The Integral PC provides a built in HP-IB interface and two 
I/O ports. A bus expander may be connected to each I/O 
port to provide space for additional interface or memory 
modules. At the time this guide was printed, the following 
interface and memory modules were available for the Integral 
PC: 

■ HP 829 19 A Serial Interface 

■ HP 82920A Current Loop Interface 

■ HP 82921A 300/1200 BPS Modem 

■ HP 82923A GPIO Interface 

■ HP 82925A 256K Memory Module 

■ HP 82927A 512K Memory Module 

For information on how to program either the HP -IB interface 
or the plug-in interfaces, refer to the HP-UX Technical BASIC 
I/O Programming Guide. 



Program 
Performance 



The use of external memory modules in the bus expander will 
increase program execution times by as much as 30 percent. If 
program execution time is critical to your application, try 
configuring the system with all memory modules located in 
the mainframe ports. 
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Number 
Representation 



Numbers are stored internally as binary numbers in HP-UX 
Technical BASIC. The following illustration shows the range 
of numbers that may be entered or stored in the Integral PC. 



Figure 2-3. 
Range of BASIC Variables 



overflow 

i 



underflow 



overflow 




REAL 



1 .7976931 3486231 5E + 308 

- 2 .225073858507202E - 308 



1 .7976931 3486231 5E + 308 



2.225073858507202E + 308 



SHORT 




3.402824E38 



3.402824E38 



1.175494E-38 



1.175494E-38 



INTEGER 






2147483647 
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storage 
Requirements 



Autostarting the 

BASIC 

Interpreter 



The following table gives the number of bytes required to 
store BASIC variables in the HP-UX disc file system. 

Data Storage Requirements 



Variable TVpe 


Bytes in BASIC/DATA File 


REAL 
SHORT 

STRING 


9 bytes. 

Individual variables or array elements: 9 bytes. 
Entire array: 5 bytes per element. 

3 bytes + 1 byte per character + 3 bytes each 
time the string crosses a logical record 
boundary. 



The BASIC interpreter may be started automatically when the 
mainframe power is first turned on by using an Autost file. 
For example, to create an Autost file that will also start the 
PAM window, use the following procedure. 



1. 



2. 



Create a working copy of the BASIC disc. (Refer to the 
getting started guide or to the user's guide for more in- 
formation on how to copy discs.) 

Create a file named Autost under the top-level directory 
on the disc and enter the following two line shell script: 



e c h o " H o i...i s t a r t i n g B fl S I C 
BASIC ttBflSIC :i: 



PI 



w ait 



3. Save the file as an HP-UX text file. 

4. Use the chmod command to add execute permission to 
the file. Type in chmod +;:•:; Rutost ( Return ) . 
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The disc is now ready to use. To automatically start BASIC 
when the power is turned on, simply insert the disc into the 
internal disc drive and turn the power on. The PAM window 
will first echo the message " N o w s t a r t i n g B fl S I C , 
Please wai t , " When the BASIC window appears, it is 
ready to use. 



Loading 
Binaries 



Binary files may be called from BASIC programs using the 
C fl L L B I H statement after the binaries have been loaded. Fol- 
low the procedure outlined in the dictionary section of the 
reference manual under C fl L L B I N to compile and load a bi- 
nary program. Remember that the file must first be linked 
outside the BASIC interpreter before it is loaded. To link a 
binary module to libraries or other modules, use the link edi- 
tor Id with the -rd options (the Id link editor is available with 
the HP-UX C Language compiler). 

To call a binary program from BASIC, use the C fl L L B I H 
statement. For example, if the binary program has an entry 
point called "EntryPoint" use the following statement: 

20 UHLLB I N " En t r ypo i n t " 



Parameters may be passed either by address or by value. For 
example, in the following statement the address of the vari- 
able addr is passed as a parameter: 



10 CflLLBIN "EntryPoint 



ddr 
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In the following example, the value of the variable nurn is 
passed as a parameter: 

10 CflLLBIH "EntryPoint" < t n u m > ;■ 

Both methods of passing parameters may be used in the same 
statement. For example: 

10 ChLLBIN "EntryPoint" 'raddr, ^num;', 15421> 

For information and examples on how to use binary programs 
in BASIC, refer to the HP-UX Technical BASIC Programming 
Guide. For more information on the CfiLLBIN and LOflDBIN 
statements, refer to the keyword dictionary section of the ref- 
erence manual. 
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3 



Uploading Series 80 
BASIC Files 



Introduction The upload utility program is provided to allow users to port 

Series 80 BASIC files to HP-UX Technical BASIC files on the 
Integral PC. 

This utility will accept files from the HP-85, 86 and 87 
computers. 

The utility will transfer the following disc-based files: 

■ Series 80 BASIC Program Files (stored as ASCII DATA 
Files). 

■ Series 80 BASIC Logical Interchange Format (LIF) Files. 

■ Series 80 BASIC DATA Files. 

■ Series 80 BASIC GRAF Files. 
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The transfer process is illustrated below. 



Figure 3-1. 
Upload Process 



Series 80 Series 80 



HP-UX 



HP-UX Technical 
BASIC 



SAVE 
"—filename" 



upload 



GET 






upload 




upload 



upload 



RENAME "—filename 





upload 





Hardware No additional hardware is required to run the upload 

Requirements program. 
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Limitations 



Number of Files. Up to 100 file names may be transferred 
in one batch from a single disc. If you need to transfer more 
than 100 files from any one disc, transfer the files in two or 
more batches. Files that have already been transferred in pre- 
vious batches must be renamed on the source disc with an 
asterisk "*" as the first character in the file name before run- 
ning subsequent batches. 

Graphic Files. The sizes of the graphic screen on the 
HP-86/87 and the Integral PC are not identical. In the Series 
80 GRiiPH mode the screen size is 400 x 240 dots; in the 
GRAPH ALL mode the screen resolution is 544 x 240 dots. On 
the Integral PC the screen size is 512 x 255 dots. When a 
Series 80 file is transferred to the Integral PC, the GRAF files 
will either be padded out with zeros or truncated to fit. The 
result of the GRAF file transfer is given below. 



Figure 3-2. 

Relative Size of Graphics 

Windows 



Mode Effect of Transfer on Series 80 GRAF File 

GRflPH Blank bytes are added in 112 bit positions on 

the right and 15 rows on the bottom. 

GRflPHflLL The rightmost 32 bit positions of each row are 
lost; blank bytes will be added in 15 rows on 
the bottom. 

The relative size and position of the various screen sizes are 
illustrated below. 



Series 80 
GRAF Mode 
240 X 400 dots 


1 

Series 80 
GRAFALL Mode 
240 X 544 dots 






Integral PC 
255 X 512 


dots 
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Data Precision and Value Range. Another limitation is 
due to the differences in the internal representation of num- 
bers. Transferring data files may result in numeric overflow or 
underflow conditions or in changes in precision. 

In the overflow/underflow condition, the utility replaces all 
overflow or underflow values with the maximum or mini- 
mum values (INF and EPS) available on the Integral PC. 

When the number to be transferred cannot be represented by 
a binary number, there will be a change in precision. Integer 
values will be transferred with no loss in precision. 

Files Containing Non-displayable Characters. With the 
default character font on the Intergral Personal Computer, 
characters with the ASCII decimal codes in the ranges 
through 31 and 128 through 159 are non-displayable charac- 
ters. When a program file is transferred to a HP-UX ASCII 
file, any non-displayable characters are escaped with a "~" 
followed by the character's three decimal digit ASCII code. 
(The ''~" is represented on the screen as "~~".) 

Because this substitution expands lines of code in Series 80 
BASIC, the resulting lines may be too long to use with the 
GET command. In this case the user will need to edit the 
ASCII text file. Once the parser has accepted the line contain- 
ing the non-printing characters, the 4-character sequence is 
stored as a 1-byte ASCII character. 



Preparation 



Microflexible 
Disc Types 



The upload program accepts both single- and double-sided 
microflexible discs. The internal disc drive in the Integral PC 
will not accept early versions of the single-sided disc that do 
not have the spring-loaded shutters (used with HP 9121 sin- 
gle-sided disc drive). If your souce disc cannot be inserted 
into the internal drive, copy the disc on your Series 80 com- 
puter to a single-sided disc with a spring-loaded shutter. 
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File Naming 
Conventions 



It is recommended that Series 80 file names be restricted to 
upper and lower case alphabetic characters, numeric charac- 
ters, the period, and the underscore character "_". 

Any files that you do not want to transfer can be masked 
with an asterisk "*" as the first character in the file name. 



Series 80 
Program Files 



Converting Series 80 Program Files to ASCII Files. 

Series 80 program files can not be directly transferred using 
this utility. Program files must first be converted into ASCII 
data files by the Advanced Programming ROM SflUE com- 
mand or by the SR'...'E command available in the GETSRUE 
binary. 

After using the S fl '...' E command to convert the program into a 
data file, rename the file to start with an underscore character 
"_" (not a minus sign or a hyphen). This is to allow the utility 
to distinquish between the Series 80 DATA files that contain 
programs, and those that contain data. This is important since 
the G E T command in HP-UX Technical BASIC cannot retrieve 
programs from DATA files. 

Series 80 BASIC Programs Containing Binary 
Programs. Any Series 80 program that contains binary pro- 
gram keywords may be transferred to an HP-UX text file. 
First use the Series 80 BASIC LOhDB I N command to load the 
binary, then SflUE the file using a file name beginning with 
an underscore character. Use the upload program to convert 
the file, then in HP-UX Technical BASIC, use the GET com- 
mand to retrieve the file. The parser will, however, flag all 
binary keywords as syntax errors or variable names. 

To avoid syntax errors, try the following: 

1. Replace binary keywords with functionally equivalent 
ROM keywords, if possible. 

2. Replace binary keywords with user defined functions or 
subprograms. 
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Series 80 DATA, 
LIF and GRAF Files 



3. Replace binary keywords with HP-UX Technical BASIC 
binary programs, for example, compiled C functions or 
subroutines. 

If the program requires extensive editing, it may be more con- 
venient to edit the program using an HP-UX editor such as vi. 
Note however that the HP-UX editors may only be used on 
ASCII text files, not on BASIC files. 

No special preparation is needed to transfer regular Series 80 
LIF, DATA or GRAF files to HP-UX text, DATA or GRAF 
files. 

However, if the Series 80 DATA file is to be edited by an HP- 
UX system editor, it may be uploaded to an HP-UX ASCII 
text file by renaming the Series 80 source file to begin with 
the underscore (_) character. 



Running the 
Upload Program 



Using the Single 
Internal Disc Drive 



Use the following procedure to transfer Series 80 files if your 
Integral Personal Computer does not have an external disc 
drive. 

1 . Insert the disc containing the upload utility program into 
the internal drive. Highlight and start the program or en- 
ter the program name in the PAM command line. The 
program window shown below will appear. 
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Upload Program Window 




2. Remove the upload disc from the internal drive and in- 
sert the source disc containing Series 80 files. Press 
Continue (QD)- 

3. The program will prompt you for the name of the disc 
drive containing the Series 80 disc. Enter the device 
name. 

Type in: inter na 1 

4. The program will prompt you to input the name of the 
destination folder. The /tmp folder should be present in 
the root folder, but it should not be used for the destina- 
tion folder. If no suitable folder exists, shuffle the 
windows to get to the PAM window and use the 
makefolder utility to create a suitable folder. Return to the 
upload window and type in the name of the destination 
folder. 
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5. If you want to copy the entire disc, press: Disc (QD)- 
If you only want to copy a portion of the disc, press the 
Files (QE)) function key. Use the Next ((J3)) func- 
tion key to move through the directory Hsting and the 
Pick {(JQ)) function key to mark files that are to be 
transferred. 

The program menu keys are summarized in the follow- 
ing table. 



Upload Menu Keys 


Menu Key 


Function 


Continue (( fl )) 


Continues to next step. 


Disc ((fl )) 


Entire Series 80 disc is uploaded. 


Files ((J8j) 


Enables user to select files. 


Catalog ((fi )) 


Provides catalog of Series 80 source disc. 


First (Q2j) 


Moves file selector to first file in directory. 


Next ((J3)) 


Moves file selector to next file in directory. 


Previous ((f4)) 


Moves file selector to previous file in directory. 


Last ((f5)) 


Moves file selector to last file in directory. 


Pick ((W)) 


Picks file selected to be uploaded. 


Quit ((f8)) 


Quits upload program. 


Larger ((fi)) 


HP-UX file will have larger logical record size 
than Series 80 source file. 


Same (( f8 )) 


HP-UX file will have same logical record size as 
Series 80 source file. 



Follow the directions in the window and use the menu 
keys provided. 

6. The program will end with the following message: 



:*: :*: F n d 



u p 1 
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Using Multipl© when using multiple external microflexible disc or 5V4-inch 
Disc DriVGS drives, do the following: 

1. Insert the utilities disc in the internal drive. Start the 
mount— disc utility. 

2. Insert the destination disc in an external drive. (If this is 
a new disc, it will need to be formatted first.) 

3. Follow the instructions in the mount— disc window and 
mount the destination disc. 

4. If you have another disc drive available, insert the Series 
80 source disc in the drive. Do not mount this disc. In- 
sert the disc containing the upload program in the 
internal drive, start the program. 

Press Continue ((TT)). 

When prompted, type in the device name of the disc 
drive containing the Series 80 files as the source. 

When prompted for the destination disc, type in the vol- 
ume label of the destination disc, starting with the root 
or "/" character. 

5. If you do not have another disc drive available, insert 
the disc containing the upload program in the internal 
drive. Start the upload program. 

Insert the disc containing the Series 80 files in the inter- 
nal disc drive. Press Continue ((TT)). 

When prompted for the source disc, type in: i n t e r n a 1 
(Return}. 

When prompted for the destination disc, type in the vol- 
ume label of the destination disc mounted in the 
external drive. 

6. Follow the instructions in the program window. After 
the program is finished, the destination disc will contain 
the uploaded Series 80 files in the HP-UX format. 
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Options The full syntax for the upload program is: 

upload -options source— device— name destination— folder— name 

The options are summarized below. 

f File by file transfer. The upload program will ask for 

the name of each file. Without this option, the pro- 
gram will copy all the files on the source disc when 
both the source and destination names are given in 
the argument string. 

n Suppresses expansion of the logical record in the 

HP-UX Technical BASIC data file. Without this op- 
tion, the program will create a DATA file that has 
logical record size 12.5 percent larger than that of 
the Series 80 file. For example, if the Series 80 file 
contains 24 byte logical records, the uploaded file 
will contain 24 byte logical records with the n op- 
tion, or 27 byte logical records without the option. 
For applications requiring random access to each 
record, do not suppress expansion of logical record 
size. 

s All Series 80 DATA files will be uploaded as HP-UX 

text files. This option ignores the file name conven- 
tions to allow uploading of DATA files to HP-UX 
ASCII text files without renaming them. 

e Disables the non-printing character conversion rou- 

tine. Without this option non-printing characters 
will be converted to a character string starting with 
the BASIC metacharacter (~) when an HP-UX text 
file is created. 

1,2,3 French, Spanish, HP-86B English language options 
(used with -e option). This option will cause the 
non-displayable characters to be mapped to the lan- 
guage character set specified. For example, in Series 
80 BASIC, the A character is mapped to the ASCII 
"NAK" character. If it is uploaded to an HP-UX text 
file, using the -e3 option, this nondisplayable char- 
acter will be mapped to ASCII A (decimal 216), 
instead of being escaped with the string "^21". 
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Ef f OP Conditions Destination Directory Full. If the destination directory be- 

comes full and there are more files to be transferred, the 
program will stop and ask the user to specify another target 
folder name. Do the following: 

if You Are Using Only the Internal Disc Drive: 

1. Remove the Series 80 disc. 

2. Insert a formatted disc. 

3. Move files from the target directory to the empty disc. 

4. Remove the disc and insert the Series 80 disc. 

5. Specify the target folder and continue transferring files. 

If You Are Using an External Disc Drive: 

1. Remove the source disc. Select the PAM window. 

2. Insert the utilities disc and start the unmount—disc pro- 
gram. Unmount the destination disc. 

3. Remove the destination disc and insert another format- 
ted destination disc. 

4. Run the mount—disc utility and mount the new destina- 
tion disc. 

5. Remove the utilities disc and re-insert the source disc. 

6. Specify the name of the new destination disc and con- 
tinue uploading programs. 

Otiier Error Conditions. Several error conditions may stop 
or terminate program execution. These error conditions are 
summarized in the table on the following page. 
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Error Conditions 



Condition 


Program Response 


Solution 


Corrupt Series 80 Files 


File will not be transferred. Pro- 


Check the file or disc on your 




gram will go on to next file in the 


Series 80 computer. 




directory. 




Source disc drive not 


Program terminates. 


Check the /dev directory for the 


found. 




device name of the disc drive. 
Refer to the Integral PC Com- 
prehensive Guide for device 
naming conventions. 


Destination folder not 


Program terminates. 


Check the root directory in PAM 


found. 




for the destination folder. If the 
destination disc is in an external 
drive, check the /dev folder for 
the disc drive device file. If the 
device file is not found, run the 
scan— discs utility. 


No valid file names or 


The program will issue a warn- 


Check the disc to be sure all 


types found on source 


ing that the disc is empty, then 


program files have been saved 


disc. 


stop. 


as ASCII data files and stored 
with the correct file name. 
Check to be sure the asterisk 
character (*) is used only to 
mark files you do not want to 
copy. 



Disc Drive 

Naming 

Conventions 



The special device files for disc drives are named using the 
following convention: 

D [volume-number] {HP-IB-address} {drive-number} 

For example, D020 is the special device file name for a disc 
drive with HP-IB address of 2, volume number 0, and drive 
number 0. Refer to the Integral PC Comprehensive Guide for 
more information on device naming conventions. 
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